Microsoft DirectX 8.1 (C++)

Displaying Closed Captioning in C++

This topic applies to Windows XP Home Edition and Windows XP Professional only.

To display closed captioning (CC), the application must activate the closed captioning feature. For analog television, the application must also active the data services feature. You can find the features by enumerating the Video Control's available features collection. To activate a feature, add it to the active features collection.

To activate the closed captioning feature, perform the following steps:

  1. Using CoCreateInstance, create an empty features collection as an MSVidFeatures object.
  2. Retrieve the available features from the Video Control, by calling the IMSVidCtl::get_FeaturesAvailable method.
  3. Loop through the returned collection, comparing each feature's CLSID against the CLSID of the CC feature. With analog TV, do the same for the data services feature. Call the IMSVidDevice::get__ClassID method to obtain the CLSID of each feature.
  4. When you find a matching feature, add it to the features collection created in Step 1. Also, query the CC feature for the IMSVidClosedCaptioning interface and store this for later use.
  5. Set the new features collection as the Video Control's active features collection, by calling the IMSVidCtl::put_FeaturesActive method.

Perform these steps before building the graph; that is, before calling IMSVidCtl::Build or IMSVidCtl::Run. If the graph is already built, call IMSVidCtl::Decompose to tear it down, and build it again afterward.

Once the CC feature is in the active features collection, you can build the graph. Enable or disable closed captioning at any time by calling the IMSVidClosedCaptioning::put_Enable method. By default, the feature is disabled.

Note   Activating the CC feature causes the Video Control to build a filter graph that is capable of receiving and displaying closed captions. Enabling the CC feature causes the captions to be displayed.

The following code example activates and enables CC. It assumes that m_pVidControl is a member variable in the control container, which holds a pointer to the Video Control's IMSVidCtl interface. The bWantDataSvc parameter specifies whether to include data services. For brevity, the example performs only minimal error checking.

HRESULT CMyContainer::ActivateCC(bool bWantDataSvc)
{
    HRESULT hr = S_OK;
    _ASSERT(m_pVidControl != NULL);  
    
    // Get the available features.
    CComPtr<IMSVidFeatures> pFeatures;
    hr = m_pVidControl->get_FeaturesAvailable(&pFeatures);
    if (SUCCEEDED(hr))
    {
        // Create an empty features collection.
        CComPtr<IMSVidFeatures> pActiveFeatures;
        hr = pActiveFeatures.CoCreateInstance(__uuidof(MSVidFeatures), 
            NULL, CLSCTX_INPROC_SERVER);
        
        // Enumerate the features and look for CC.
        long lCount = 0;
        pFeatures->get_Count(&lCount);
        for (long ix = 0; ix < lCount; ix++)
        {
            CComVariant var(ix);
            CComPtr<IMSVidFeature> pFeature;
            GUID clsid;
            hr =  pFeatures->get_Item(var, &pFeature);
            hr = pFeature->get__ClassID(&clsid);
            if (clsid == __uuidof(MSVidClosedCaptioning))
            {
                // Found CC, add it to the collection.
                hr = pActiveFeatures->Add(pFeature);
                CComQIPtr<IMSVidClosedCaptioning> pCC(pFeature);
                if (pCC) {
                    hr = pCC->put_Enable(VARIANT_TRUE);
                }
            }
            else if (bWantDataSvc && clsid == __uuidof(MSVidDataServices))
            {
                hr = pActiveFeatures->Add(pFeature);
            }
        }
        // Set this collection as the active features collection.
        hr = m_pVidControl->put_FeaturesActive(pActiveFeatures);
    }
    return hr;
}